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This  is  a  highly  graphic  user-oriented  interactive 
software  product  which  will  assist  the  user  to  become  more 
proficient  at  recognizing  and  employing  Navy  signal  flags 
and  pennants  which  are  used  for  visual  ccmmunlcaticns 
between  naval  vessels  of  all  types.  A  tutorial  portion  of 
the  program  has  been  designed  with  a  number  of  options, 
thereby  allowing  a  user  to  tailor  a  recognition  program  to 
satisfy  specific  learning  requirements.  The  program  is  also 
capable  of  graphically  displaying  any  grouping  of  flags  and 
pennants  chosen  by  the  user  in  flaghoist  order.  When  the 
flags  and  pennants  are  arranged  in  accordance  with  the  pro¬ 
cedural  doctrine  set  forth  in  the  ALLIED  MARITIME  TACTICAL 
SIGNAL  BOOK,  ATP  1(B),  Volume  II,  the  program  demonstrates 
the  capability  of  decoding  the  displayed  signal  into  its 
predetermined  meaning.  The  current  program  is  resident  in 
the  Secure  Command,  Control  and  Communications  Exercise  La¬ 
boratory  (C3  Lab)  at  the  Navy  Postgraduate  School . 
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I.  INTRODUCTION 


A.  BACKGROUND 

Most  visual  communications  systems  presently  in  use  on 
board  United  States  Navy  ships  have  been  employed  in  much 
the  same  manner  for  centuries.  Their  continued  use  is  evi¬ 
dence  of  their  utility  and  significance.  Of  the  visual  sys¬ 
tems  incorporated  today,  "flaghoist"  is  the  one  most  fre¬ 
quently  used,  even  though  its  use  is  limited  to  the  hours  of 
daylight.  Flaghoist  is  commonly  used  for  close-in  communi¬ 
cations  in  the  fleet. 

Flaghoist  involves  the  use  of  coded  flags  and  pennants. 
Usually  these  flags  and  pennants  are  displayed  prominently 
on  a  hoist  running  up  to  a  yardarm  on  the  ship's  mast.  Each 
"flag"  (to  include  pennants)  represents  a  letter,  a  numeral, 
or  a  designated  special  meaning.  One  flag  or  a  grouping  of 
flags  in  a  prescribed  order  constitute  a  signal.  In  gen¬ 
eral,  a  flaghoist  signal  ensures  a  more  uniform  execution  of 
a  maneuver  than  any  other  system  of  visual  communications. 

Flaghoist  signaling  provides  a  rapid  and  accurate  system 
cf  passing  tactical  and  administrative  information. 
Flaghoist  is  rapid  because,  by  hoisting  and  displaying  one 
cr  more  flags  that  have  a  predetermined  meaning,  a  ship  can 
communicate  simultaneously  with  all  ships  in  company.  It  is 


;n  accurate  system  fcr  the  reason  that  the  receivers  cf  the 
signal  are  required  to  repeat  tne  signal,  flag  for  flag,  al¬ 
lowing  the  originator  to  immediately  confirm  that  these  sent 
tae  signal  received  it  correctly.  In  addition,  flaghoist 
signaling  aptly  meets  many  security  previsions,  which  can  be 
considered  a  prime  requisite  for  naval  communications.  Not 
cnly  is  the  range  limited,  the  meaning  of  the  signal  itself 
can  only  oe  found  in  a  classified  signal  publication.  Fi¬ 
nally,  flaghoist  signaling  may  be  the  only  means  of  expedi¬ 
tious  tactical  communications  during  emergency  conditions 
when  any  sort  cf  electronic  emissions  from  a  snip  may  be 
prohibited  for  the  very  safety  of  that  ship. 

In  flaghoist  signaling,  the  U.  S.  Navy  uses  68  flags. 
These  include  the  international  alphabet  flags  (26),  numeral 
pennants  (10),  and  a  Code/Answer  pennant;  a  set  of  numeral 
flags  (10),  special  flags  and  pennants  (17);  and  four  sub¬ 
stitutes,  or  repeaters.  Each  alpnabet  flag  has  the  pnonetic 
name  of  the  letter  it  represents.  A  numeral  FLAG  takes  the 
name  cf  tne  numeral  it  represents;  numeral  PENNANTS  are  cnly 
used  In  cell  signs.  Special  flags  and  pennants  are  used  in 
tactical  maneuvers  tc  direct  changes  tc  speed,  position, 
course,  and  formation,  to  indicate  and  identify  units,  and 
for  specialized  purposes.  In  addition  to  the  flags  used  for 
signaling,  there  is  the  tackline  or  "tack".  The  tackline  is 
used  to  separate  flags  or  groups  of  flags  which,  if  not 
separated,  could  convey  another  meaning  from  that  intended. 
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In  most  cases  the  tack  is  included  in  the  signal  to  avoid 
any  ambiguity. 

A  flaghoist  signal  (message)  consists  of  two  rerts: 
heading  and  text.  The  heading  may  he  specified  by  hoisting  a 
visual  call  sign?  nurerals  in  the  "call"  of  the  heading  are 
numeral  pennants.  More  frequently,  the  heading  is  implied, 
and  all  that  is  hoisted  is  the  text  portion  of  the  signal. 
The  text  usually  is  made  up  of  flag  combinations  extracted 
from  the  ALLIED  MARITIME  TACTICAL  SIGNAL  EOOK,  ATP  1(B), 
Volume  II.  A  signal  is  read"  d y  noting  the  flag  positions 
starting  from  the  top  most  outboard  flag  down  the  halyard  to 
the  bottom  flag,  then  to  the  next  most  outboard  top  flag 
aown  to  the  bottom,  etc.,  etc.  A  "display"  is  a  complete 
signal,  whether  on  one  halyard  or  on  two  or  more. 

ATP  1(B),  Vol.  II  is  the  origin  of  most  tactical  commun¬ 
ications  between  allied  naval  units.  The  signal  vocabulary 
of  this  publication  is  collected  into  chapters  and  arranged 
under  headings  for  ease  of  reference.  Chanter  1  contains 
general  instructions  for  use  of  the  book.  Chapter  2  contains 
single  flag  and  pennant  signals.  Chapter  3  contains  emergen¬ 
cy  alarm  and  emergency  action  signals.  Charters  4  through  9 
contain  maneuvering  signals  which  utilize  a  special  pennant. 
Chapters  Id  througn  31  contain  the  main  signal  vocabulary, 
which  consists  of  operational  and  administrative  signals  ar¬ 
ranged  in  alphabetical  order  under  appropriate  headings. 
Chapter  32  consists  of  supplementary  tables  which  are  used 


Id 


tc  augment  and  modify  the  meaning  of  certain  basic  grouos. 
The  signal  vocabulary  chapters  are  followed  by  an  extensive 
signal  index  provided  to  assist  the  user  in  finding  the 
desired  groups  when  encoding  signals.  The  overall  security 
classification  of  ATP  1(B),  Vol.  II  is  NATO-CONFIDENTIAL, 
which  requires  a  NATO  special  clearance  (for  confidential 
material)  in  order  to  be  able  to  view  its  contents. 

Due  to  the  classification  of  the  ALLIED  MARITIME  TACTI¬ 
CAL  SIGNAL  BOOK  and  the  sheer  number  of  possible  combina¬ 
tions  of  messages  that  can  be  formulated,  all  enlisted  per¬ 
sonnel  and  officers  responsible  for  decoding  flaghoist  sig¬ 
nals  are  actively  discouraged  from  trying  to  memorize  any 
signal  contained  in  the  publication.  Even  if  an  individual 
‘thinks  he  knows'  the  meaning  of  a  group  of  flags,  there  is 
a  standing  requirement  to  lock  the  signal  up  in  the  publica¬ 
tion  before  reporting  the  meaning  to  a  senior. 

The  enlisted  rating  which  Is  responsible  for  visual  com¬ 
munications  on  board  a  ship  is  that  of  Signalman.  Besides 
ether  duty  responsibilities  Signalman  personnel  are  required 
to  acquire  and  maintain  a  solid  background  and  knowledge  in 
procedures,  methods,  and  rules  pertaining  tc  flaghoist  com¬ 
munications.  Fundamental  to  this  tasking  is  a  proficiency  in 
readily  identifying  all  signal  flags  and  pennants  used. 
Signalman  "a"  School  presently  devotes  five  hours  of  in¬ 
structional  time  to  the  learning  of  the  signal  flasrs. 
Within  the  officer  ranks,  every  prospective  Surface  Warfare 


Naval  Officer  receives  a  minimum  of  four  hours  of  formal 
classroom  instruction  and  practice  in  signal  flag  recogni¬ 
tion.  Besides  the  time  set  aside  in  the  classroom  to  learr. 
the  identity  cf  all  the  flags  and  pennants  -nest  individuals 
(enlisted  and  officers)  who  have  to  learn  them  require  an 
additional  minimum  of  seven  tc  ten  hours  to  become 
"moderately  proficient"  with  a  "fair"  amount  cf  retention 
capability. 

The  primary  aid  currently  used  by  an  individual  in 
learning  and  studying  the  flags  outside  the  classrccm  is  the 
"Navy  and  Interna t  ional  Code  Flag  Cards”,  device  number 
5LL2J  this  is  a  product  cf  the  U.S. Naval  Training  Device 
Center  produced  by  Brown  and  Eigelow  (FSN :2Z-£910-514-2Z33 ) . 
The  "flash-cards"  device  consists  cf  ?5  playing-card -sized 
cards  with  a  color  picture  of  a  flag  or  pennant  on  one  side, 
and  the  name  of  the  flag  or  pennant  on  the  other. 

E.  OBJECTIVE 

The  main  objective  of  this  study  was  tc  produce  a  sim¬ 
ple,  user  oriented,  yet  all  inclusive  and  foolproof  computer 
program  routine  which  would  be  able  to  "teach"  a  user  the 
signal  flags  and  pennants,  and  in  addition,  have  the  capa¬ 
bility  to  "decode"  such  flags  and  pennants  displayed  in 
groups  in  accordance  with  standard  procedures  delineated  in 
ATP  1(B) ,  Vol .  II . 
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In  striving  tc  realize  the  above  stated  objective  other 
less  significant  objectives  were  achieved  in  the  process. 
Among  these  objectives  were: 

(1)  To  incorporate  the  C3  Laboratory — its  assets  and  in¬ 
herent  capabilities — as  an  integral  and  major  part  of 
the  thesis  itself; 

(2)  To  actively  apply  various  programming  techniques  and 
design  principles  expounded  in  various  academic 
courses  to  a  specific  real-world  and  Service  related 
topic  of  interest;  and, 

(3)  To  create  a  product  which  has  the  potential  to  be  a 
meaningful  contribution  to  the  U.S.  Navy. 


1 
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II.  PROGRAMMING  OBJECTIVES  AND  DESIGN  PRINCIPLES 

The  graphic  tutorial  and  decoding  program  for  Navy  sig¬ 
nal  flags  and  pennants  which  satisfies  the  above  objective 
was  designed  to  be  used  on  a  PDP  11/70  computer  located  in 
the  Secure  Command,  Control  and  Communications  Exercise  La¬ 
boratory  (C3  Lab),  at  the  Navy  Postgraduate  School.  The  C3 
Lab  was  developed  for  use  as  a  research,  test  and  evalua¬ 
tion,  and  experimentation  facility.  Designated  a  Remote 
Site  Module  (RSM),  the  C3  Lab  is  part  of  a  secure  computer 
network  which  also  includes  the  Naval  Ocean  Systems  Center 
INOSC),  in  San  Diego,  California,  Commander-in-Chief,  U.S. 
Pacific  Fleet,  in  Pearl  Harbor,  Hawaii,  and  the  fleet  Numer¬ 
ical  Oceanographic  Center,  located  in  Monterey,  California. 
This  secure  network  is  referred  to  as  the  Advanced  Command 
and  Control  Architectural  Testbed  (ACCAT),  and  is  certified 
to  be  able  to  handle  and  store  classified  material  up  to  and 
including  SECRET.  A  UNIX  operating  system  is  resident  in 
the  C3  Lab's  PDP  11/70,  and  provides  an  on-line  (time¬ 
sharing)  computing  system  capability.  In  addition  to  Ann  Ar¬ 
bor  CRT  terminals  for  entry/retrieval  (I/O),  the  system  sup¬ 
ports  color  graphics  on  Genisco  display  terminals. 

By  understanding  and  taking  advantage  of  the  close  in¬ 
teractive  relationship  between  user  and  computer  which  is 
engendered  by  an  on-line  system,  an  effective  user-oriented 
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program  can  be  realized.  To  assemble  ana  collocate  such  a 
user-oriented  program  was  the  primary  programming  objective. 
To  this  end,  the  final  criteria  used  to  determine  whether 
cede  was  to  be  incorporated  or  rejected  in  the  tutorial  and 
decoding  program  was  if  the  inclusion  of  some  particular 
code  contributed  in  making  the  program  more  user-oriented. 

In  the  design  cf  a  program  where  there  is  a  high  degree 
of  interaction  anticipated,  perhaps  the  most  important  con¬ 
sideration  is  the  "appearance"  cf  the  program  to  the  user 
("the  man-machine  interface").  A  program  must  be  appealing 
for  a  user  to  want  to  use  it  more  than  once.  And  if  the 
program  is  to  be  utilized  by  a  variety  of  individuals  having 
varied  levels  of  expertise  or  experience,  it  has  to  be 
designed  and  formated  in  such  a  manner  so  that  ANY  user  can 
understand  what  is  expected  at  each  point.  Consequently, 
the  more  "advanced"  user  may  have  to  accept  and  be  tolerant 
cf  this  possible  Inconvenience  although  there  are  design  op¬ 
tions  that  could  be  incorporated  which  have  the  potential  to 
alleviate  this  problem  to  a  great  degree.  Such  "human  en¬ 
gineering"  considerations  within  a  program  can  be  some  of 
the  mest  time  consuming  and  troublesome  to  resolve  in  creat¬ 
ing  a  program. 

There  are  a  number  of  generally  accepted  "design  princi¬ 
ples"  that  should  be  considered  when  creating  a  user  orient¬ 
ed  interactive  program.  All  the  following  design  principles 
were  utilized  in  the  tutorial  and  decoding  program. 


(l)  Self-explana tor/ . 


(2)  Self-helping. 

(3)  Simple  interface  with  user. 

(4)  Interaction  by  anticipation. 

(5)  Optional  verbosity. 

(6)  Echoing 

Although  more  "transparent"  to  a  user  than  those  above, 
the  following  are  also  considered  as  necessary  elements  for 
a  truly  successful  user  oriented  interactive  pregram. 

(7)  The  exiting  from  a  program  should  be  a  "reversible 
reques  t " . 

(6)  The  program  should  be  able  to  accept  direct  comment 
from  the  user. 

(9)  The  user  should  never  be  embarrassed,  belittled  or 
chastised. 

Each  one  of  the  above  listed  design  principles  is 
described  more  fully  in  the  following  remaining  paragraphs. 

A  "self-explanatory"  program  is  one  which  presents  the 
user  sufficient  tutorial  information  about  the  program  it¬ 
self  to  enable  the  user  to  proceed  without  reference  to  seme 
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external  source  of  explanation  ta  separate  user's  manual  for 
example).  This  is  accompli  shed  by  presenting  certain  neces¬ 
sary  and  basic  items  and  allowing  the  user  to  opt  for  addi¬ 
tional  supplementary  cr  tutorial  material  if  desired. 

A  "sel f-helpinir"  program  provides  checking  of  user  in¬ 
puts  to  the  program  and  provides  reminders  or  advisories 
when  the  user  requests  help.  This  is  accomplished  by  check¬ 
ing  the  input  for  validity  or  reasonableness,  and  if  ap¬ 
propriate,  sending  a  diagnostic  message.  This  message  might 
inform  the  user  that  the  last  entered  input  is  incorrect  ei¬ 
ther  in  format  (usually  a  typing  error),  or  content.  When  a 
user  specifically  requests  assistance,  the  program  should  be 
structured  to  respond  in  some  manner  providing  the  user  with 
enough  helpful  information  to  resolve,  hopefully  to  the 
user's  satisfaction,  the  apparent  predicament  the  user  is 
experiencing. 

"Simple  interface  with  user"  is  accomplished  by  ensuring 
that  the  actions  and  inputs  required  by  the  user  are  short, 
simple,  and  obvious.  One  aspect  of  the  interface  is  the 
grouping  of  options  presented  within  the  program.  For  exam¬ 
ple,  if  many  options  are  available,  it  is  probably  easier 
for  an  on-line  user  to  make  his  choice  if  the  options  can  be 
presented  in  subgroups  of  six  or  fewer  items.  More  than  this 
amount  can  become  "mind  boggling"  and  is,  therefore,  coun¬ 


terproductive. 


"interaction  by  anticipation"  is  achieved  by  anticipat¬ 
ing  ell  possible  desires  a  user  may  have  and  presenting  the 
user  with  choices  which  include  all  of  those  possibilities. 
This  method  enables  the  user  to  SELECT  (by  letter/number/or 
short  phrase)  rather  than  SPECIFY  (type  out  in  entirely)  a 
desired  option. 

"Optional  verbosity"  allows  for  two  (or  more)  levels  of 
detail  to  occur  in  the  interface  with  the  user.  For  the  no¬ 
vice  or  first-time  user,  the  interface  should  contain  de¬ 
tailed  explanations  in  order  to  insure  that  the  user  com¬ 
pletely  understands  what  is  expected,  and  what  the  program 
is  capable  of  performing.  On  the  other  hand,  an  experienced 
user  familiar  with  the  program  or  subject  matter  might  want 
to  choose  a  mode  of  operation  with  few  or  nc  explanations 
and  abbreviated  communications  (terse  messages).  A  verbosity 
option  can  resolve  the  problem  between  presenting  tco  much 
or  too  little. 

"Echoing"  (which  could  be  a  verbosity  option  itself)  al¬ 
lows  the  user  instant  feedback  in  order  to  verify  that  the 
input  entered  (which  may  even  be  used  or  enacted  upon  at  a 
later  time)  has  been  accepted  and  that  it  indeed  was  the 
correct  option/input  desired  in  the  first  place. 

A  "reversible  request"  provides  the  user  "one  last 
chance”  to  consider  the  consequences  of  the  most  recently 
entered  action  without  any  dire  consequences  occurring.  In 
the  exiting  of  a  program,  the  user  is  asked  if  termination 
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is  actually  desired.  If  termination  is  indeed  desired 
reconfirmed),  the  user  is  thanked,  and  then  allowed  exit 
(gracefully)  from  the  program.  If,  on  the  other  hand,  the 
user  wishes  to  return  to  the  program  and  continue,  the  pro¬ 
gram  returns  the  user  to  the  point  in  the  program  previously 
located. 

A  pregram  is  only  useful  if  it  can  satisfy  a  user's 
needs  and  requirements.  Since  many  of  these  desires  are  not 
fully  known  until  the  user  is  actually  using  it,  a  built-in 
feature  to  accept  "keyed  in"  comments,  criticism,  or  sugges¬ 
tions  can  be  extremely  vorthwnlle.  Net  only  will  it  permit 
the  user  to  vent  possible  anger,  the  comments,  where  feasi¬ 
ble,  can  be  invaluable  in  developing  improvements  to  the  ex¬ 
isting  program  thereby  enhancing  the  overall  man-machine  in¬ 
terface  appearance  of  the  program  itself. 

Finally,  a  program  is  a  tool.  If  it  somehow  conveys  an 
attitude  of  "superiority"  to  the  user,  the  user  may  be  in¬ 
clined  not  to  employ  it.  Therefore,  a  conscientious  and 
deliberate  effort  must  be  made  on  the  part  of  the  creator  of 
a  program  to  treat  the  user  with  respect  and  courtesy.  No 
other  approach  toward  the  user  can  be  as  effective. 
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III.  PROGRAM  DESCRIPTION 


The  graphic  tutorial  and  decoding,  program  for  Navy  sig¬ 
nal  flags  and  pennants  that  was  created  consists  of  12 
separately  compiled  programs  which  have  been  structured  to 
interact  with  one  another.  Certain  values  are  carried 
between  various  programs  to  maintain  continuity  among  all  of 
the  programs.  Memory  space  limitations  during  the  compila¬ 
tion  of  a  program,  and  the  conscientious  effort,  in  keeping 
with  good  programming  practices,  to  "modularize"  the  program 
into  a  number  of  less  cumbersome  programs  was  the  rationale 
behind  breaking  up  the  program  into  the  12  separate  pro¬ 
grams.  Any  one  of  the  12  programs  can  virtually  "stand 
alone"  and,  therefore,  each  can  be  considered  as  an  indepen¬ 
dent  program.  However,  these  independent  programs  when  dis¬ 
cussed  in  this  thesis  will  be  referred  to  as  "subprograms”; 
when  the  subprograms  are  considered  all  together,  they  make 
up  the  graphic  tutorial  and  decoding  "program". 

A.  OVERVIEW 

This  program  provides  a  structure  designed  to  assist  an 
individual  in  learning  to  recognize  the  Navy  signal  flags 
end  pennants  and,  secondly,  to  assist  in  decoding  visual 
flaghoist  signals  in  accordance  with  the  ALLIED  MARITIME 
TACTICAL  SIGNAL  BOOK. 
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The  graphics  contained  in  the  program  are  used  to  por¬ 
tray  and  display:  the  twenty-six  International  alphabet 
flags,  the  ten  numeral  pennants,  ana  a  code/answer  pennant; 
a  set  cf  the  numeral  flags?  seventeen  special  fla^s  and  pen¬ 
nants;  four  substitute  pennants,’  and  a  tackline  or  "tack". 
In  the  tutorial  portion,  tnese  flags  and  pennants  are  shewn 
individually;  in  the  display/decode  portion,  they  are 
displayed  in  any  number  up  to  32  on  "halyards"  in  order  to 
simulate  signal  flags  and  pennants  as  they  would  be  used  to 
send  a  message  from  a  ship.  There  are  also  graphics  presen¬ 
tations  which  depict  the  program  framework  in  which  the  user 
will  be  working.  In  each  case  the  user's  present  location  in 
the  program  is  identified,  thereby  living  a  visual  perspec¬ 
tive  of  wnere  the  user  is  in  relationship  to  the  rest  of  the 
pr oeram . 

£.  STRUCTURE 

The  structure  of  the  program  consist  of  two  main  POR¬ 
TIONS;  the  tutorial  PORTION,  end  the  display/decode  PORTION. 
The  tutorial  PORTION  has  been  divided  into  three  SECTIONS, 
and  each  SECTION  has  three  SEGMENTS.  Each  SEGMENT  (within  a 
tutorial  SECTION;  is  further  subdivided  intc  either  three  cr 
four  graphic  tutorial  SESSIONS  where  the  flags  and  pennants 
are  actually  presented.  The  d lsplay/deccde  PORTION  has  one 
SECTION.  Figure  1,  on  the  next  page,  depicts  this  structure. 
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Fig  1.  Diagram  Depicting  Program  Sequence  (Flow)  and 

User  Options  Available  (Continued  on  next  page) 
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(cont).  Diagram  Depicting  Program  Sequence  (Flow)  and 

User  Options  Available  (Continued  from  previous  page) 


The  "Main  Selection  Level  Menu  '  is  the  center  branching 
point  within  the  program.  It  presents  the  user  with  six 
choices  to  choose  from.  These  are: 

INTERNATIONAL  ALPHAEET  FLAGS  (TUTORIAL) 

NUMERAL  FLAGS  AND  PENNANTS  (TUTORIAL) 

SPECIAL  FLAGS  AND  PENNANTS  (TUTORIAL) 

FLAGHOIST  DIS PLAY /DECODE 

DETAILED  PROGRAM  DESCRIPTION/DIAGRAM 

QUIT 

A  brief  description  of  each  selection  follows. 

(1)  International  Alphabet  Flags  (Tutorial)  —  This  SEC¬ 
TION  contains  a  complete  self-contained  tutorial, 
which  will  provide  the  user  a  framework  to  become  more 
proficient  In  the  ability  to  recognize  the  26  Interna¬ 
tional  Alphabet  flags. 

(2)  Numeral  Flags  and  Pennants  (Tutorial)  —  This  SECTION 
contains  a  complete  self-contained  tutorial,  which 
will  provide  the  user  a  framework  to  become  more  pro¬ 
ficient  in  the  ability  to  recognize  the  10  Interna¬ 
tional  Numeral  pennants  and  the  10  Navy  Numeral  flags. 

(3)  Special  Flags  and  Pennants  (Tutorial)  —  This  SECTION 
contains  a  complete  self-contained  tutorial,  which 
will  provide  the  user  a  framework  to  become  more  pro- 
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flcient  in  the  ability  tc  recognize  21  special  pen¬ 
nants  or  flags.  The  flags  and  pennants  contained  are: 
preparative,  interrogative  and  negative  (governing 
pennants);  emergency,  formation,  station,  turn,  cor- 
pen,  speed  and  screen  (maneuvering  pennants);  first, 
second,  third  and  fourth  substitutes  (repeater  pen¬ 
nants);  starboard  (direction  pennant);  port  (direction 
flag);  division  and  squadron  (unit  indicator  flags); 
and  designation  pennant  and  ccde/answer  pennant. 


(4)  Flaghoist  Display/Decode  —  This  SECTION,  which  is  the 
display/decode  PORTION  of  the  prcxram,  is  for  the  most 
part  "transparent”  to  the  user.  It  is,  however,  a  sig¬ 
nificant  part  of  the  program.  It  allows  the  user  to 
display  the  flags  and  pennants  that  compose  a  signal 
which  is  to  be  sent  or  received.  It  also  has  the  ca¬ 
pability  to  decode  the  signal  if  the  display  conforms 
to  proper  flaghoist  signaling  procedures  as  delineated 
in  the  ALLIED  MARITIME  TACTICAL  SIGNAL  BOOK.  The  user 
is  advised  if,  for  any  reason,  the  present 
flag/pennant  arrangement  cannot  be  decoded. 


(5)  Detailed  Program  Description/Diagram  —  this  selection 
provides  the  user  with  a  detailed  program  description 
which  appears  on  the  terminal,  while  simultaneously 
presenting  a  graphic  structure  diagram  on  the  color 
screen.  This  description/diagram  is  the  same  option 
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the  user  is  given  when  first  entering  the  program  It 
is  intended  to  give  the  user  a  perspective  on  the  pro¬ 
gram,  what  options  are  available,  and  the  user's 
current  location  within  the  program.  This  selection 
automatically  returns  the  user  to  the  Main  Selection 
Level  Menu  at  the  completion  of  the  presentation. 

(6)  Cult  —  this  selection  allows  the  user  to  quit  (exit) 
the  program.  In  fact  this  is  an  option  that  the  user 
may  opt  for  at  any  time  when  an  input  is  required  to 
"advance’  the  program.  However,  before  being  permit¬ 
ted  to  actually  leave  the  program,  the  user  is  re¬ 
quested  to  type  in  any  pertinent  comments  about  any 
aspect  of  the  program.  The  quit  process  is  reversible* 
the  user  will  be  returned  to  the  same  place  In  the 
program  If  If  he  decides  not  to  terminate. 

Within  each  of  the  above  first  three  selections  -  the 
tutorial  PORTION  of  the  program  -  the  user  Is  given  the 
choice  of  selecting  one  of  three  SEGMENTS ,  besides  three 
other  options. 

TRAINING  SEGMENT 
REVIEW  SEGMENT 
QUIZ  SEGMENT 

BRIEF  DESCRIPTION  OF  SEGMENTS 
RETURN  TO  MAIN  SELECTION  LEVEL  MENU 
QUIT 
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A  brief  description  cf  eacn  SEGMENT  follows.  Inhere  the 
word  "flag"  appears  it  is  to  mean  to  be  either  a  flag  or  a 


pennant . 

il)  Training  Segment  —  will  provide  the  user  with  the  op¬ 
portunity  to  learn  and  study  one  single  flag  at  a  time 
from  the  flags  in  the  SECTION  selected.  By  presenting 
the  user  one  randomly  selected  flag  at  a  time  along 
with  its  proper  WHITTEN  name  (except  in  the  case  cf 
the  International  Alphabet  Flags  where  the  SPOKEN  name 
is  given),  the  user  can  go  through  the  mental  process 
of  associating  a  flag  with  a  name.  The  size  or  the 
group  of  flags  from  which  a  particular  flag  is  select¬ 
ed  is  an  option  chosen  by  the  user.  A  flag  will 
remain  on  the  color  screen  as  long  as  the  user  desires 
to  have  it  displayed.  The  same  flag  will  not  appear 
until  six  other  flags  have  been  presented.  Another 
flag  automatically  appears  each  time  the  carriage  re¬ 
turn  hey  is  depressed. 

(2)  Review  Segment  —  will  allow  the  user  to  chocse 
from  two  options.  The  first  option  presents  one  ran¬ 
domly  selected  flag  at  a  time  from  the  SECTION  in  a 
similar  manner  as  in  the  Training  Segment.  Howev¬ 
er,  unlike  in  the  Training  Segment,  the  name  of  the 
flag  does  not  appear  simultaneously  thereby  giving 
the  user  the  opportunity  to  identify  the  flag  "on 
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his  own".  The  correct  name  of  the  flag  is  delayed  for 
four  seconds.  When  it  appears  it  essentially  pro¬ 
vides  instant  feedback  to  the  user  either  in  the  form 
of  reinforcement  if  properly  identified  or  of  correc- 
ticn  if  wrongly  identified.  The  second  option  re¬ 
quires  the  user  to  type  (enter)  the  name  of  the  flag 
that  is  desired  to  be  presented  on  the  screen. 
Each  time  a  name  is  typed  the  specific  flag  is 

shown.  By  entering  "all",  the  usci  's  shewn  all  the 

flags  in  the  SECTION  on  the  screen  simultaneously. 

This  "call  up"  option  allows  for  the  flag  of 

the  user's  own  choosing  to  be  shown,  thereby  provid¬ 
ing  the  structure  for  the  user  to  go  through  the 

mental  process  of  of  associating  a  name  with  a  flag. 

(3)  Quiz  Segment  —  will  present  the  user  with  one  random¬ 
ly  selected  flag  at  a  time  from  the  SECTION.  The  flag 
will  remain  on  the  screen  for  five  seconds  and  then 
disappear.  The  user  is  then  required  to  identify  the 
flag  by  typing  in  its  name  on  the  keyboard.  The  user 
is  informed  by  an  advisory  if  what  is  entered  is 
correct  or  not.  If  correct,  a  new  quiz  flag  is 
presented.  If  incorrect,  the  flag  will  reappear  and 
the  user  is  given  anoVter  chance  to  identify  it.  The 
flag  will  not  disappear  after  five  seconds  as  before) 
it  will  remain  on  the  screen  until  another  input  by 


the  user  is  made.  If  the  user  correctly  identifies  it, 
an  advisory  informs  the  user  and  a  new  quiz  flag  is 
offered.  If  incorrectly  identified,  the  flag's  name 
is  given  and  the  program  then  presents  the  user  a  new 
flag  to  identify.  The  quiz  can  he  terminated  at  any 
time.  When  the  user  ends  the  quiz,  a  score  in  given 
based  on  the  number  of  correctly  identified  flags  made 
on  the  initial  viewing  of  the  flag.  The  names  of  those 
flags  that  were  incorrectly  identified  after  being 
given  two  opportunities  are  listed. 

C.  INDIVIDUAL  SUBPROGRAM  DESCRIPTIONS 

By  referring  to  Appendix  B  a  complete  description  of 
each  of  the  subprograms  can  be  obtained.  The  "Program  Sum¬ 
mary  Statement"  located  at  the  beginning  of  each  subprogram 
has  been  extracted  directly  from  each  of  the  source  subpro¬ 
grams  and  contains  a  "description"  and  a  "content"  section. 
The  description  contains  a  detailed  sequential  run-through 
of  what  each  subprogram  outwardly  presents  to  the  user.  The 
content  contains  a  brief  outline  of  the  structure  which  is, 
for  the  most  part,  transparent  to  the  user.  The  content 
section  also  delineates  the  subprogram's  relationship (s  ) 
with  other  subprograms. 

The  complete  source  code  for  each  of  the  subprograms  was 
originally  to  be  included  as  part  of  the  thesis.  However, 
because  of  the  length  of  some  of  the  subprograms,  this  ln- 
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elusion  was  considered  as  impractical.  Access  to  the  code  is 
a  relatively  easy  evolution  to  perform  for  anyone  who  wishes 
to  obtain  a  copy  of  any  (or  all)  of  the  source  subprograms . 
Appendix  A  outlines  the  necessary  procedure  to  acquire  ac¬ 
cess  . 

Figure  2,  located  on  the  next  page,  depicts  the  rela¬ 
tionships  the  various  subprograms  have  among  one  another. 
The  titles  on  the  diagram  are  the  compiled  programs'  names 
as  they  are  actually  called. 


IV.  RECOMMENDATIONS  EOR  FUTURE  DEVELOPMENT 


First,  although  the  current  program  has  met  the  stated 
objective  and  it  has  incorporated  within  it  all  the  design 
features  that  are  considered  as  necessary  tc  have  a  success¬ 
ful  user-oriented  interactive  program,  there  are  several 
additions"  which  could  be  included  at  seme  later  date  to 
make  it  even  more  appealing.  Second,  the  curren‘  decoding 
portion  of  the  program  shows  only  a  "capability";  it  con¬ 
tains  the  code  necessary  to  decode  only  a  few  of  the 
chapters  in  ATP  1(B),  Vol  II.  The  present  capability  is 
listed  in  Appendix  C.  Last,  the  entire  objective  must  be 
examined  in  the  context  of  "cost  versus  value",  and  a  deter¬ 
mination  must  be  made  whether  the  pursuit  of  a  fully  opera¬ 
tional  product  is  a  worthy  endeavor. 

The  envisioned  long  range  application  for  the  program  is 
to  install  such  a  program  onboard  a  naval  vessel  for  at-sea 
use.  Hardware  necessary  to  support  the  program  would,  by 
necessity,  most  likely  have  to  be  reduced  to  a  "desk  top" 
configuration  with  the  possibility  of  running  several  remote 
graphic  CRT's,  if  graphics  were  desired?  and  a  "hand  calcu¬ 
lator"  configuration  if  graphics  were  not  particularly 
necessary.  The  program  would  be  used  when  a  vessel  was  re¬ 
ceiving  a  flagholst  (or  flashing  light  or  semaphore)  mes¬ 
sage.  The  duty  signalman  would  enter  the  flags  on  a  keyboard 


as  they  are  visually  read.  After  entering  the  flags  which 
make  up  the  signal,  the  user  merely  has  tc  type  "decode", 
verify  or  confirm  that  the  flags  are  the  ones  sent,  before 
reading  the  meaning  of  the  signal  cn  a  screen  (CRT)  or  In  a 
window.  The  Commanding  Officer  and/or  Officer  of  the  Deck 
could  also  be  provided  with  a  remote  CRT  so  that  the  message 
could  be  instantaneously  delivered  to  the  ultirate  intended 
receiver.  The  tutorial  portion  of  the  program  would  be  util- 
ized  onboard  ship  to  keep  proficiency  high  in  recognition  of 
the  flags,  and  on  shore  at  these  installations  where  signal 
flag  training  is  a  requirement  (for  example,  Signalmen  "a" 
School,  Officer  Candidate  Schccl  and  Surface  Warfare  Officer 
School ) . 

One  of  the  'additions'  that  would  make  the  program  more 
appealing  would  be  to  reduce  and/or  convert  the  present  pro¬ 
gram,  which  is  dependent  on  the  PDP  11/70  and  Genisco,  to 
one  which  fits  into  a  microcomputer  with  a  graphics  capabil¬ 
ity  or  into  (smaller  still)  a  pocket  translator/calculator 
size  device  without  a  graphics  capability.  Putting  the  pro¬ 
gram  (excluding  the  graphics  capability  for  the  present 
time)  on  a  "chip"  so  that  it  could  be  then  easily  updated 
and  even  encrypted  when  necessary  in  order  that  it  then 
could  be  put  into  some  small  hand  held  device  is  the  ulti¬ 
mate  goal.  To  speed  the  process  between  reading  the  flags 
and  being  presented  the  meaning,  voice  input  of  the  flags 
possibly  could  be  added.  In  any  case,  memory  space  and  size 
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studies  would  have  to  be  conducted  on  the  feasibility  of  any 
of  the  above  configurations  before  the  present  program  could 
be  made  more  readily  available  to  its  potential  users  in  the 
Fleet . 

Before  the  program  can  be  considered  completely  ready 
for  evaluation  and  use,  the  decoding  portion  of  the  program 
must  be  finished.  Presently,  the  program  can  only  claim  to 
demonstrate  the  capability.  The  author,  however,  has  care¬ 
fully  selected  those  chapters  thus  far  incorporated  in  the 
program  as  representative  of  the  remaining  material  in  ATP 
1(B),  Vol  II.  For  this  reason  there  does  not  appear  to  be 
anything  more  intricate  to  program  than  what  has  already 
been  done.  Memory  space  may  become  a  limitation,  but  this 
should  not  be  difficult  to  overcome  on  the  PBP  11/70. 
Research  into  possibly  a  better  method  and/cr  language  to 
code  this  portion  of  the  program  could  lead  to  a  program 
more  efficient  overall. 

A  premise  of  this  thesis  was  that  the  stated  objective 
was  worthy  enough  to  develop  an  alternate  approach  in  order 
to  satisfy  it.  Now  that  an  alternative  has  been  developed. 


the 

user  community  should 

be  approached 

to  see 

if  such  a 

product  has  real  "user  appeal 

".  If  it  is 

wel  1 

received , 

still 

another  major  hurdle  must  be  overcome. 
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(and 

encoding) 

flaghoist  displayed  signals  consists  of  a  pack  of 

68  flash 

34 


cards  and  one  formidable  publication.  What  is  proposed  to 
replace  these  items  would  require  a  rather  sophisticated, 
though  easy  to  operate,  piece  of  computer  equipment. 
Although  the  cost  of  such  equipment  is  decreasing  continu¬ 
ously,  it  may  still  be  toe  high  to  make  it  practical.  A  cost 
versus  value  study  would  have  to  be  conducted  before  further 
substantial  time  investments  are  deveted  to  actually  writing 
the  decoding  code.  It  is  the  opinion  of  the  author  after 
studying  the  matter,  that  the  tutorial  and  decoding  product 
is  beneficial  from  the  user's  standpoint,  but  that  its  mone¬ 
tary  cost  may  be  prohibitive  at  this  time. 

The  final  improvement  that  is  recommended  would  be  to 
create,  design  and  develop  a  natural  language  ENCODE  coun¬ 
terpart  to  the  decode  portion  of  the  program.  This  would  be 
a  formidable  undertaking  but  great  strides  have  been  made 
recently  in  natural  language  query  routines  and  systems, 
^any  of  the  techniques  derived  could  be  applicable  in 
developing  an  efficient  encoding  scheme. 
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APPENDIX  A 


PROGRAM  OPERATING  INSTRUCTIONS 

An  individual  desiring  eitner  tc  view  the  source  code  or 
run  the  "Graphic  Tutorial  and  Decoding  Program  for  Navy  Sig¬ 
nal  Flags  and  Pennants”  must  first  place  the  program's 
’’  source  and  object  files  into  his/her  directory.  This  is  ac¬ 

complished  by  making  the  necessary  arrangements  to  or  fol- 
«.  lowing  the  procedures  for  mounting  a  magnetic  tape  labeled 

"FLAGS",  which  is  stored  in  the  03  Lab  in  the  custody  of  the 
manager  of  the  C3  Lab. 

k  To  run  (execute)  the  tutorial  and  decoding  PROGRAM,  once 

w 

all  the  subprograms  are  loaded/transferred  into  the  user's 

directory,  the  subprogram  "flag"  should  be  initially  called. 

"Flag"  is  the  only  subprogram  which  offers  the  user  a  choice 

of  Genisco  screens  which  can  be  activated,  and  which  allows 

the  user  to  choose  another  section  of  the  program  in  which 

to  go.  If  called  first,  all  other  subprograms  will  automati¬ 
cal 

v '  cally  default  to  Genisco  screen  "0"  (left  bey  screen  in  the 

C3  Lab).  Moreover,  when  in  certain  subprograms  the  command 
t  "main"  is  entered — which  is  required  prior  to  being  able  tc 

select  another  section — the  subprogram  will  exit  automati¬ 
cally  and  return  the  user  back  to  the  UNIX  executive  shell 
level  unceremoniously  and  without  any  advance  warning. 
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Cnee  "flag"  is  called,  the  user  should  be  able  to  util¬ 
ize  the  program  as  long  as  desired.  The  program  was  inten¬ 
tionally  designed  and  structured  to  "stand  alone"  (i.e.,  to 
be  self  explanatory)  and  does  not  require  any  user's  manual. 
If  the  user  does  encounter  a  situation  which  is  seetringly 
ambiguous  or  confusing,  entering  "help"  or  "?"  will  provide 
an  advisory  which  will  delineate  the  options  available  to 
rectify  the  situation.  The  user  must,  however,  have  some 
knowledge  of  flaghoist  procedures  and  terminology  to  derive 
maximum  benefit  from  the  decoding  section  of  the  program.  No 
other  operator  instructions  should  have  to  be  given  to  the 
prospective  user  before  beginning  the  program. 

The  program  is  self-helping  and  uses  simple  interface 
commands.  The  user  has  the  opportunity  to  view  detailed  in¬ 
structions  and  a  graphic  diagram  describing  the  entire  pro¬ 
gram  Just  after  entering  the  program.  If  the  user  opts  not 
to  see  these,  he  can  bypass  them  and  go  directly  into  the 
main  Selection  Level  l“ienu  (l"SLM)»  however  these  instructions 
are  always  available  to  the  user  as  one  of  the  options  in 
the  MSLM. 

The  program  employs  the  techniques  of  interaction  by  an¬ 
ticipation  since  the  commands  required  to  progress  through 
the  program  are  the  characters  corresponding  to  the  correct 
name  of  the  flag  or  pennant.  The  remaining  commands  are 
consistent  in  their  meaning  throughout  the  program,  and 
should  not  be  ambiguous  to  even  the  novice  user. 
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The  program  contains  defaults  in  case  the  user  mistypes 
an  input.  If  the  input  is  not  immediately  acted  upon,  the 
program  will  echo  the  user's  entry.  Within  the  decoding 
portion  of  the  program  there  is  a  verbosity  option  which  al¬ 
lows  the  user  to  tailor  the  amount  of  information  received 
after  an  entry  is  made.  There  are  three  different  verbosity 
levels  to  choose  from. 

The  program  allows  the  user  to  quit  and  exit  the  program 
from  any  pcint  but  requires  the  user  to  verify  his  intention 
to  quit  before  the  program  halts  and  returns  to  the  UNIX 
shell  command  level.  Prior  to  quitting,  the  user  is  re¬ 
quested  to  enter  any  comment(s)  that  may  be  considered  ap¬ 
propriate  . 

In  order  to  monitor  the  utility  of  the  program,  code  has 
been  incorporated  within  two  of  the  subprograms  which  will 
record  time  of  user  entry  and  exit,  along  with  any  comments 
that  the  user  makes  when  quitting  the  program.  These  sub¬ 
programs  will  have  to  be  modified  if  someone  (other  than  the 
author)  would  like  this  information.  Subprograms  "flag.c” 
and  "quit.c"  have  been  documented  sufficiently  to  permit 
someone  else  to  do  this. 

All  the  subprograms  are  written  in  the  "c"  language.  A 
basic  understanding  of  "c”  is  necessary  if  the  reader  in¬ 
tents  to  modify  the  subprograms  themselves.  A  conscientious 
effort  was  made  to  provide  detailed  documentation  along  with 
each  subprogram. 
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All  the  subprograms  were  compiled  using  the  compiler 
command  kcc".  For  eiample,  to  compile  the  subprogram 
flag.c”  (all  programs  must  have  a  filename  of  the  form 
( filename) .c" )  the  shell  command  "kcc  (filename)"  is  en¬ 
tered  followed  by  a  carriage  return.  ”kcc”  is  a  filename 
itself  containing  the  following  compiler  command  calls: 
cc  $l.c  /usr/graphics/genlib  .a 
/usr/graphics/genl i o .a  /us r /graph! cs /genii b. a 

This  compiler  allows  more  streamlined  graphics  commands  to 
be  used  in  the  Genisco  source  code. 
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APPENDIX  B 


SUBPROGRAM  SUMMARY  STATEMENTS 


FROGRAM:  flag.c 

PROGRAM  SUMMARY  STATEMENT 

DESCRIPTION:  THE  INITIALLY  CALLED  PROGRAM  FOR  TEE  NAVY 
SIGNAL  FLAGS  AND  PENNANTS  PROGRAM. 

USSR  IS  GREETED  TO  PROGRAM  CN  THE  CRT,  AND  REQUESTED  TO 
AUTOMATICALLY  WITE  SOME  BASIC  PROGRAM  REMINDERS.  FOLLOWING 
THIS  THE  USER  IS  GIVEN  A  CHOICE  OE  WHAT  GENISCO  SCREEN  IS 
TO  BE  UTILIZED.  AFTER  THIS  HAS  BEEN  DETERMINED  AND  THE 
SELECTION  ECHOED,  TEE  PROGRAM  TEEN  PRESENTS  TO  USER  TEE 
FORMAL  INTRODUCTION  TO  THE  PROGRAM  ON  THE  GENISCO  SCREEN, 
FOLLOWED  BY  AN  OVERVIEW  OE  THE  OBJECTIVES  07  THE  PROGRAM  ON 
TEE  CRT.  TEE  USER  IS  TEEN  ASKED  IF  A  MORS  DETAILED 
DESCRIPTION  OF  THE  PROGRAM  -  WITH  A  GRAPHIC  DIAGRAM  -  IS 
DESIRED.  IF  THE  USER  SELECTS  THIS  OPTION  A  SIX  PART 
SIMULTANEOUS  CRT/SCRSEN  DES CRIPT ION /DIAGRAM  PRESENTATION  IS 
PROVIDED.  THE  USSR  CARRIAGE  RETURN  KEY.  AT  TEE  END  OF  THIS 
OPTION  THE  USER  IS  AUTOMATICALLY  PROVIDED  WITH  THE  MAIN 
SELECTION  LEVEL  MENU  ( MSLM )  WHERE  EE  MAY  MAKE  ONE  OF  SIX 
CHOICES.  IF  THE  USER  DID  NOT  SELECT  THE  DESCRIPTI ON /DIAGRAM 
OPTION,  THE  MSLM  IS  PRESENTED  IMMEDIATELY  AFTER  TEE  POINT 
WHERE  WEEN  TEE  USSR  INDICATED  TEAT  TEE  OPTION  WAS  NOT 
DESIRED. 

CONTENTS:  TRANSPARENT  TO  THE  USER  WHEN  SIGNING-IN  IS  THAT 
THE  NAME  BEING  ENTERED  IS  AUTOMATICALLY  BEING  PLACED  IN  A 
FILE  CALLED  'INPUT'  IN  A  DIRECTORY  PRESENTLY  WITHIN  'EIZN'. 
'NOTS:THS  'PROGRAM  MONITOR'  WILL  HAVE  TO  INSURE 
TEAT  AN  'INPUT'  FILS  IS  MAINTAINED  IN  HIS/HER  DIRECTORY  AND 
THAT  flag.c  IS  PROPERLY  MODIFIED  TO  HANDLE  THIS.  TEIS  ALSO 
MUST  BE  DONE  IN  THE  qult.c  SUBPROGRAM.]  WHEN  THE  CARRIAGE 
RETURN  IS  TYPED  TEE  CURRENT  TIME  IS  ALSO  PLACED  IN  THE 
FILE  'INPUT'  UNDER  THE  HEADING  OF  'TIME  LOGGED  IN:'  THIS 
FILE  'INPUT'  HAS  BEEN  CREATED  IN  ORDER  TO  MONITOR  USE  OF 
TEE  PROGRAM,  AND  ALSO— MORE  IMPORTANTLY— AS  AN  RECEPTACLE 
FOR  USER  INPUT  COMMENTS  WHICH  ARE  SOLICITED  WHEN  THE  USER 
INDICATES  THAT  HE  DESIRES  TO  'QUIT'  (EXIT)  THE  PROGRAM. 

'.SEE  quit.c  PROGRAM  FOR  MORE  DESCRIPTION  OF  TEIS  OPTION.) 


A  CONCERTED  EFFORT  HAS  EEEN  MADE  IN  ORDER  TO  MAKE  THE 
PROGRAM  WHERE  'AUTOMATIC  ADVANCEMENT'  Cl  THE  PROGRAM  IS  NOT 
PRESENT.  IN  OTHER  WORDS,  EVERYWHERE  THAT  TEE  USER  MUST 
TYPE  IN  SOME  ENTRY  -  RE  IT  EVEN  A  CARRIAGE  RETURN  -  AND  AN 
ERRONEOUS  ENTRY  IS  MADE  INSTEAD  Of  THE  ONE  (OR  ONE  FROM  THE 
GIVEN  SELECTION)  FROMPTED  FOR,  AN  ADVISORY  WILL  RE  GIVEN 
INFORMING  THE  USER  THAT  WHAT  WAS  JUST  TYPED/ENTERED  WAS  NOT 
ACCEPTED  AND  THAT  ANOTHER  INPUT  IS  NECESSARY  TO  CONTINUE 
TEE  PROGRAM.  THERE  ARE  ALSO  ADVISORYS  PROVIDED  IF  TEE  USEP 
GETS  'CONFUSED'  CR  'LOST'  AND  TYPES  '?'  OR 

THE  PROGRAM  AUTOMATICALLY  FORKS  TO  (AND  RETURNS  FROM) 
intro. c  AFTER  SCREEN  SELECTION  HAS  BEEN  DETERMINED.  THE 
PROGRAM  FORKS  TO  alphab.c  IF  INTERNATIONAL  ALPEAEET  FLAGS 
SELECTED;  TO  numbs. c  IF  NUMERAL  FLAGS  AND  PENNANTS 
SELECTED;  TO  special. c  IF  SPECIAL  FLAGS  AND  PENNANTS 
SELECTED;  TO  submain.c  IF  FLAGHO 1ST  DISPLAY  SELECTED;  TO 
quit  ,c  IF  QUIT  SELECTED;  OR  TO  THE  SUBROUTINE  DescrO  IF 
THE  USSR  WANTS  TO  REVIEW  THE  DES CR I PT ION /DIAGRAM 
PRESENTATION  OPTION  AFTER  VIEWING  TEE  MAIN  SELECTION  LEVEL 
MENU. 


PROGRAM:  intro. c 

PROGRAM  SUMMARY  STATEMENT 

DESCRIPTION:  PROVIDES  THE  OPENING  GRAPHICS  FOR  TEE  NAVY 
SIGNAL  FLAGS  AND  PENNANTS  PROGRAM.  DISPLAYS  FLAGS  WEICH 
SPELL  CUT  IN  CLEAR  TEXT  'NAVY  FLAGS  AND  PENNANTS'  FOLLOWED 
BY  WRITTEN  TITLE  OF  PROGRAM  AND  AUTHOR'S  NAME. 

CONTENTS:  CALLED  AUTOMATICALLY  BY  flag.c,  AND  RETURNED 
AUTOMATICALLY  TO  flag.c.  CONTAINS  NO  OPTIONS.  ENTIRE 
SUBPROGRAM  IS  NON-INTERACTIVE.  (SUGGEST  THIS  SUBPROGRAM  BE 
BYPASSED  WHEN  ACCESSING  flag.c  A  NUMEER  OF  TIMES  WHILE 
PERFORMING  ANY  SORT  OF  MAINTENANCE.  SEE  flag.c  AT  FORK  TO 
THIS  SUBPROGRAM  FOR  SUBSTITUTE  CODE  FOR  BYPASSING  THIS 
SUBPROGRAM. ) 
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PROGRAM:  alphab.c  ***(ALSC  [numbs. c]  AND  {  s  pec  i  a  1  .c  } }  *** 

PROGRAM  SUMMARY  STATEMENT 

DESCRIPTION :  BY  SELECTING  TP.IS  OPTION  THE  USER  DESIRES  TO 
LEARN/STUDY  THE  INTERNATIONAL  ALPHARET  FLAGS  (26)  [TEE 
NUMERAL  FLAGS  (13)  AND  PENNANTS  (10)]  ( THE  SPECIAL  FLAGS 
AND  PENNANTS  (21)}  . 

THE  USER  IS  PROVIDED  WITH  A  SECTION  MENU  WITH  CHOICE  OF 
FOUR  MAIN  OPTIONS  ^BESIDES  CAPABILITY  TO  QUIT  AND  TO  RETURN 
TO  THE  MAIN  SELECTION  LEVEL  MENU  ( MS  LM )  } ,  DEPENDING  ON  WHAT 
SEGMENT  l TYPE  OF  FLAG  PRESENTATION)  IS  DESIRED.  THE 
TRAINING  SEGMENT  PROVIDES  ONE  SINGLE  RANDOM  FLAG  WITH  ITS 
CORRECT  NAME  SIMULTANEOUSLY?  REVIEW  SEGMENT  PROVIDES  TWO 
MAIN  OPTIONS  WITHIN  ITSELF:  (1)  A  RANDOM  FLAG  DISPLAYED 
WITH  FOUR  SECOND  DELAY  OF  THE  FLAG'S  NAME,  (2)  FLAG 
DISPLAYED  WITH  NO  NAME  (FLAG  NAME  TYPED  ON  KEY  BOARD  TO 
CALL  FLAG  TO  SCREEN.)  OR  BY  ENTERING  SCREEN  TOGETHER?  AND 
QUIZ  SEGMENT  WHICH  PRESENTS  A  RANDOM  FLAG  AND  USER  MUST 
PROVIDE  NAME.  A  SCORE  IS  MAINTAINED  IN  THIS  SEGMENT.  THE 
FORTE  OPTION  PROVIDES  USER  WITH  A  BRIEF  DESCRIPTION  OF  EACH 
OF  THE  SEGMENTS  FOR  USER'S  PERUSAL.  WITHIN  THE  TRAINING  AND 
QUIZ  SEGMENTS  THERE  ARE  THREE  TUTORIAL  SESSIONS?  WITHIN  THE 
REVIEW  SEGMENT  THERE  ARE  FOUR  SESSIONS.  THE  FIRST  SESSION 
WITHIN  ANY  OF  THE  SEGMENTS  DISPLAYS  A  RANDOM  FLAG  FROM  ONE 
HALF  OF  ALL  THE  FLAGS  IN  THE  SECTION  (A-M  [0-9]  (10  SPECIAL 
PENNANTS}),  TEE  SECOND  SESSION  WITHIN  ANY  OF  TEE  SEGMENTS 
DISPLAYS  A  RANDOM  FLAG  FROM  THE  REMAINING  FLAGS  IN  THE 
SECTION  (N-Z  [p0-p9]  {11  SPECIAL  PENNANTS})  AND  THE  THIRD 
SESSION  TAKES  A  RANDOM  FLAG  FROM  THE  ENTIRE  GROUF  OF  FLAGS 
AVAILABLE  (A-Z  [0-9  &  p0-p9]  {21  SPECIAL  PENNANTS}).  THE 
FOURTH  SESSION  WITHIN  THE  REVIEW  SEGMENT  ALLOWS  THE  USER  TO 
DISPLAY  ANY  FLAG  OF  THE  USER'S  OWN  CHOOSING,  CR  ALL  THE 
FLAGS  TOGETHER. 

CONTENTS:  THERE  ARE  NO  LIMITATIONS  TO  A  TUTORIAL  SESSION? 
WHEN  THE  USER  DESIRES  TO  TERMINATE  A  SESSION  ALL  TEAT  IS 
REQUIRED  IS  'end'  TO  BE  ENTERED.  THE  USER  WILL  EE  RETURNED 
THE  SECTION  MENU  AT  TEE  END  OF  EVERY  SESSION.  THE  USER  MAY 
RETURN  TO  THE  MSLM  OR  QUIT  FROM  EITHER  A  SESSION  OR  AT  THE 
SECTION  MENU  LEVEL.  HOWEVER,  ONCE  A  SEGMENT  HAS  BEEN 
SELECTED,  THE  USER  IS  NOT  PERMITTED  TO  RETURN  TO  THE  MSLM 
OR  QUIT  UNTIL  THE  USER  IS  WITEIN  A  TUTORIAL  SESSION. 

CALLED  FROM  flag.c  MAIN  SELECTION  LEVEL  MENU  WITH  INPUT  'a' 

C ' n ' 3  {'s'}.  FORKS  TO  allalphab.c  [allnumbs.c] 

{allspecial  .c}  IF  USER  SELECTS  COMMAND  'all'  IN  TEE  CALL  UP 
OPTION  OF  REVIEW  SEGMENT.  FORKS  BACK  TO  flag.c  WITH  Vain'? 
TO  quit.c  WEEN  'quit'  ENTERED. 
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PROGRAM:  allalphab.c 

i.  AL S 0  [all numb s  .c]  AND  {all  spec  ia  1 .  c }  )** 
PROGRAM  SUMMARY  STATEMENT 

DESCRIPTION:  DISPLAYS  TO  THE  USER  ALL  THE  26  [20]  {21} 
SLAGS/PENNANTS  IN  THE  SECTION  ON  THE  SCREEN  AT  ONE  TIME. 

CONTENTS:  CALLED  FROM  alphab.c  [numbs. cl  {special. c}  WITH 
INPUT  SUBPROGRAM  WHEN  ALL  FLAGS /PENNANTS  ARE  DISPLAYED. 
CONTAINS  NO  OPTIONS.  ENTIRE  SUBPROGRAM  IS  NCN-INTERACTI VE . 


PROGRAM:  submain.c 

PROGRAM  SUMMARY  STATEMENT 

DESCRIPTION:  GREETS  USER  TO  DISPLAY/DECODING  PORTION  OF 
PROGRAM.  PROVIDES  USER  INPUT  REMINDERS  AND  THEN  PRESENTS 
THE  CURRENT  DECODING  CAPABILITIES  BUILT  INTO  TEE  PROGRAM. 
THE  USER  IS  THEN  GIVEN  THE  OPTION  TO  CHOOSE  FROM  THREE 
LEVELS  OF  VERBOSITY.  NEXT  THE  USER  IS  GIVEN  THREE  OPTIONS 
FROM  WHICH  TO  CEOOSE  WHAT  FLAGHOIST  DISPLAY  CONFIGURATION 
IS  DESIRED.  THE  FINAL  OPTION  PROVIDES  THE  USER,  IF  CHOSEN, 
WITH  ALL  THE  VARIOUS  KEYSTROKE  COMMANDS  (OTHER  THAN 
FLAG /PENNANT  NAMES)  WEICE  WILL  BE  ACCEPTED. 

CONTENTS:  (THIS  SUBPROGRAM  PRIMARILY  WRITTEN  BECAUSE  OF 

MEMORY  SPACE  LIMITATIONS  IN  f laghois t  .c  .  )  SUBPROGRAM 
PROVIDES  STRUCTURE  FOR  INTRODUCTION  TO  DISPLAY/DECODING 
PORTION.  BOTH  VERBOSITY  AND  DISPLAY  CHOICES  ARE  ECHOED. 
DEPENDING  ON  WHAT  VERBOSITY  SETTING  CHOSEN,  SOME  ADVISORY 
INFORMATION  EITHER  PROVIDED  OR  OMITTED. 

CALLED  FROM  flag.c  MAIN  SELECTION  LEVEL  MENU  WITH  IN¬ 
PUT  'fix'  (FLAGHOIST).  FORKS  TO  commands. c  IF  USER  SELECTS 
COMMAND  OPTION?  FORKS  AUTOMATICALLY  TO  flaghcist.c  AT  END. 
FORK  OPTION  TO  quit.c  AND  flag.c  (AT  MSLM)  AVAILABLE  AT 
CERTAIN  POINTS. 
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FROGRAM :  flaghoist.c 


PROGRAM  SUMMARY  STATEMENT 

DESCRIPTION:  PROVIDES  USER  WITH  CURRENT  VERBOSITY  AND 
DISPLAY  SETTINGS.  INFORMS  USER  TEAT  FLAGS  MAY  BEGUN  TO  EE 
DISPLAYED.  ALLOWS  USER  TO  TYPE  IN  ANY  FLAG  OR  PENNANT  BY 
NAME  AND  DISPLAYS  FLAG  OR  PENNANT  ON  A  SIMULATED  HALYARD  OF 
THE  USER'S  CHOOSING  IN  FLAGHOIST  ORDER.  USER  MAY 
CHANGE/MODIFY  FLAGS  DISPLAYED  BY  USING  APPROPRIATE  COMMANDS 
PROVIDED  FROM  THE  'COMMANDS'  LISTING.  WHEN  THE  USER  HAS  THE 
SIGNAL  DISPLAYED  ON  TEE  SCREEN  WHICH  EE  WANTS  TO  HAVE 
DECODED,  THE  COMMAND  'decode'  IS  ENTERED.  THE  PROGRAM 
RETURNS  THE  NAME  OF  THE  FLAG ( S )  AND  ITS  (THEIR)  FLAG 
POSITION(S)  FOR  THE  USER  TO  CONFIRM,  BEFORE  ATTEMPTING  TO 
DECODE  THE  SIGNAL.  MEANING  OF  SIGNAL  IS  NATO  CONFIDENTIAL 
WHEN  ARRANGEMENT  OF  FLAGS  AND  MEANING  ARE  ASSOCIATED. 

CONTENTS:  CALLED  FROM  submain.c  AUTOMATICALLY  WEEN 
submain.c  ENDS.  FORKS  TO  commands .c  WHEN  EITHER  'commands' 
CR  'help'  ENTERED;  AUTOMATICALLY  RETURNED  AFTER  COMMANDS 
ARE  PRESENTED  ON  CRT.  ACCEPTS  ANY  CORRECT  FLAG  NAME  OR 
COMMAND  AND  EITHER  DISPLAYS  FLAG  OR  EXECUTES  COMMAND.  FORKS 
TO  ato.c  SUBPROGRAM  IF  USER  SO  INDICATES  A  DESIRE  TO  KNOW 
IF  THE  DISPLAYED  FLAGHOIST  SIGNAL  IS  VALID  I.E.,  EAS  A 
MEANING.  ALLOWS  USER  TO  LOOP  AS  MANY  TIMES  AS  DESIRES;  WHEN 
USER  CHANGES  DISPLAY  OPTION  ALL  FLAGS  ARE  REMOVED?  DISPLAY 
OPTION  TWO  (  'disp2 ' )  NOT  CURRENTLY  AVAILABLE  DUE  TO  MEMORY 
SPACE/COMPILE  CONSTRAINTS.  FORK  OPTION  TO  quit.c  AND 
f lag .c  AT  THE  MS DM  AVAILABLE  AT  ANY  TIME. 

NOTE  TO  ADVANCED  USERS  OF  TEE  PROGRAM:  BY  TYPING  'flag- 
hoist'  FROM  THE  UNIX  SHELL  LEVEL,  THIS  SUBPROGRAM  CAN 
BE  ACCESSED  DIRECTLY  WITHOUT  HAVING  TO  GO  THROUGH  TEE  MSLM 
(flag.c)  OR  THE  DISPLAY/DECODING  PORTION  INTRODUCTION 
(sutmain.c ) .  HOWEVER,  IF  THE  VERBOSITY  AND  DISPLAY 
SETTINGS  ARE  NOT  IMMEDIATELY  CHANGED  TO  VALUES  THAT  ARE 
RECOGNIZED  BY  THE  PROGRAM,  THE  SUBPROGRAM  WILL  NOT  FUNCTION 
IN  A  STAND  ALONE  CAPACITY.  REMEMBER,  THIS  SUBPROGRAM  WILL 
ONLY  OPERATE  IN  THIS  MODE  AT  TEE  LEFT  BAY  SCREEN  IN  THE  C3 
LAB  BECAUSE  OF  THE  DEFAULT  TO  GENISCO  -0  WHICH  OCCURS  WHEN 
NOT  INITIALLY  GOING  THROUGH  flag.c. 


PROGRAM:  corrp-.ands .  c 


PROGRAM  SUMMARY  STATEMENT 

DESCRIPTION :  LISTS  ALL  THE  COMMANDS  AVAILABLE  FOR  MODIFYING 
DISPLAYED  FLAGS,  CR  FOR  CHANGING  VEREOSITY  LEVEL  AND 
DISPLAY  CONFIGURATION. 

CONTENTS:  CALLED  BY  submaln.c  OR  flaghoist.c.  RETURNS  TO 
CALLING  SUBPROGRAM  WEEN  CARRIAGE  RETURN  (OR  ANY  OTHER 
INPUT)  ENTERED?  NO  OTHER  OPTIONS  ARE  AVAILABLE. 


PROGRAM :  atp.c 

PROGRAM  SUMMARY  STATEMENT 

DESCRIPTION:  PROVIDES  THE  USER  WITH  THE  MEANING  OF  THE 
DISPLAYED  FLAGS/PENNANTS  ON  CRT. 

CONTENTS:  ALMOST  ENTIRELY  TRANSPARENT  TO  THE  USER,  THIS 
SUBPROGRAM  CONSISTS  OF  ONE  VERY  LARGE  'IF'  LOOP  WHICH 
ATTEMPTS  TO  SEARCH  FOR  A  MATCH  BETWEEN  WHAT  IS  IN  THE  FIRST 
ONE  TO  FOUR  FLAG  POSITIONS  WITH  A  'DATA  BASE'  CONSISTING  OF 
BASIC  GROUPS  EXTRACTED  FROM  ATP  1(B),  VOL  II.  WEEN  A 
MATCH  OCCURS  THE  MEANING  IS  PRESENTED  AND  THE  SEARCH 
CONTINUES  USING  THE  NEXT  GROUP.  A  GROUP  IS  DEFINED  AS  AN 
ARRAY  OF  THOSE  UNIQUE  FLAG  NUMBERS  UP  TO  BUT  NOT  INCLUDING 
A  TACK  (66)  OR  A  SPACE  (0).  TACKS  AND  SPACES  ARE 
DISREGARDED  BUT  ARE  USED  AS  END  OF  ARRAY  AUTOMATICALLY  TO 
flaghoist.c  AFTER  ALL  FLAG  NUMBERS  HAVE  BEEN  SEARCEED  FOR 
AND  MEANING  HAS/HAS  NOT  BEEN  FOUND  AND  PRESENTED  ON  THE 
SCREEN.  IF  NO  MATCH  IS  FOUND,  AN  ADVISORY  INFORMING  THE 
USER  OF  THIS  IS  PRESENTED. 

THIS  SUBPROGRAM  IS  NATO-CONFIDENTIAL  AND  SHOULD  EE  ACCORDED 
THE  PROPER  SECURITY  FOR  SUCH  A  CLASSIFICATION. 
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PROGRAM:  ^uit.c 

PROGRAM  SUMMARY  STATEMENT 

DESCRIPTION :  REQUESTS  THE  USER  EEEORS  TERMINATING  THE 
PROGRAM  TO  TYPE  IN  ANY  COMMENTS  THAT  ARE  DEEMED 
APPROPRIATE.  IF  THE  USER  WISHES  NOT  TO  COMMENT,  (S)HE  THEN 
MAY  EXIT  DIRECTLY.  IF  THE  USER  DESIRES  TO  RETURN  TC  THE 
PROGRAM,  (S )EE  ENTERS  'ret'  AND  IS  REINSTATED  AT  TEE  SAME 
LOCATION  IN  THE  PROGRAM  AS  BEFORE. 

CONTENTS:  PRESENTS  A  GRAPHICS  'TO  WARN'  USER  THAT  TEE  END 
OF  TEE  PROGRAM  MAYBE  NEAR.  IF  USER  INDICATES  TEAT  (S  5 EE 
WISHES  (WILLING)  TO  MAKE  SOME  COMMENTS,  THE  'INPUT'  FILE  IS 
OPENED  TC  RECEIVE  ENTRIES  UP  TO  EIGHT  LINES  IN  LENGTH?  TIME 
OF  EXIT  ALSO  ENTERED.  IF  THE  USER  INDICATED  THAT  NO 
COMMENTS  ARE  WANTED  TO  BE  MADE  'INPUT'  OPENED  TO  RECORD 
TIME  OF  EXIT  AND  AUTOMATIC  ENTRY  OF  'NO  COMMENT ' .  (SEE  ALSO 
flag.c. ) 

CALLED  BY  flag.c,  alphab.c,  numbs. c,  special. c,  subrrain.c, 
OR  flagholst.c.  RETURNS  TO  CALLING  SUBPROGRAM  WHEN  'ret' 
ENTERED.  ALLOWS  USER  TO  'EXIT  GRACEFULLY'  FROM  THE  PROGRAM. 
PROCESS  IS  REVERSIBLE. 

SINCE  RETURNING  TO  THE  UNIX  SHELL  COMMAND  (THE  REAL 
INTERPRETATION  OF  QUITTING)  CAN  ONLY  BE  ACCOMPLISHED  BY 
EXITING  OUT  THROUGH  THE  INITIALLY  ENTERED  PROGRAM,  A 
PROSESS  WAS  DEVISED  TO  'BACKTRACK'  THROUGH  THE  VARIOUS 
SUBPROGRAMS  FORKED  INTO.  THIS  WAS  ACCOMPLISHED  BY  CARRYING 
A  VALUE  IN  THE  'exit'  ARGUMENT.  A  PRIOR  TO  ENTERING  THE 
quit.C  SUBPROGRAM?  A  '1'  (ONE)  VALUE  WOULD  RETURN  AIL  THE 
WAY  BACK  TO  flag.c  WHERE  IT  THEN  WOULD  RETURN  TO  THE  UNIX 
SHELL.  (SEE  ADDITIONAL  DOCUMENTATION  WITHIN  SUBPROGRAM.) 


APPENDIX  C 


CURRENT  PROGRAM  DECODING  CAPABILITY 

The  following  is  extracted  directly  from  the  ’’submain.c" 
subprogram  and  lists  the  current  decoding  capability  of  the 
program . 

PRESENTLY  INCORPORATED  IN  THE  DECODING  PORTION  OF  THE 
PROGRAM  ARE  THE  FOLLOWING  CHAPTERS,  ARTICLES,  PARAGRAPHS 
FROM  ATP  1(B),  VOL  II.  (AS  OF  15  MAR  91) 


Ill 

GOVERNING 

PENNANTS 

112 

GOVERNING 

GROUPS 

115 

PLAIN  TEXT  (NOTE  1) 

122 

UNITS  OF  : 

REFERENCE  (partial)  (NOTE  l) 

123 

FRACTIONS 

(NOTE  1) 

124a ,c 

TIMES 

126b, c 

BEARING  AND  DIRECTION/DISTANCE  (NOTE  1) 

126a ,b  ,c 

METHOD  OF 

ORDERING  SECTORS  (NOTE  l) 

301 

EMERGENCY 

EXECUTE  SIGNAL 

302 

EMERGENCY 

ALARM  SIGNALS 

303 

EMERGENCY 

ACTION  SIGNALS 

1001 

ANTIAIR  WARFARE  SIGNALS 

NOTE  1 : WHERE  APPLICABLE  IN  SIGNALS  EXTRACTED  FROM  CHAPT  3-32. 
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